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【 摘 要 】 现 阶段 Revit 网 架 建 模 存 在 很 多 次 端 。 


100044) 


常规 建 模 方法 由 于 杆 件数 量 过 多 导致 建 模 工 作 量 繁重 ,难以 检查 


修改 。 应 用 体 量 模 型 建 模 速度 虽 快 但 整体 模型 不 够 准确 ,构件 参数 不 能 单独 设置 。 为 了 提高 设计 效率 、 提 升 建 模 

精度 ,本 文采 用 Microsoft 公司 的 visual studio2015 开发 平台 ,对 Revit 进行 二 次 开发 ,编写 网 架 自动 化 建 模 程 序 。 本 

程序 通过 读 取 LOG 文本 加 载 焊接 空心 球 节点 族 和 杆 件 族 ,快速 方便 、 准 确 地 生成 Revit 焊接 空心 球 网 架 模型 ,适用 
工 于 非 曲面 标准 网 架 。 生 成 的 网 架 可 以 按照 LOG 文本 更 换 对 应 构件 的 种 类 ,网 架 整 体 尺寸 与 实际 情况 相符 , 极 大 的 
| 及 较 少 了 设计 工作 人 员 的 工作 量 ,提高 了 设计 效率 和 建 模 质 量 。 
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> 一 BIM 的 概念 在 建筑 领域 逐渐 被 更 多 的 人 认可 ， 
龙 其 被 明确 写 信 住 建部 “一 三 五 ”规划 后 ,BIM 的 发 
展 趋势 更 加 迅速 。 Autodesk 公司 的 Revit 不 仅 自身 
拥有 强大 的 功能 ,还 为 使 用 者 提供 了 丰富 的 APL, 逐 
浙 成 为 世界 上 主流 的 BIM 平台 。 早 在 2005 年 公司 
就 开始 提供 API 接口 ,在 不 断 更 新 的 十 多 年 里 ,Re- 
vifggPI 得 到 了 快速 的 发 展 ,其 功能 也 越 来 越 强大 。 
借助 于 API 我 们 可 以 把 琐碎 的 建 模 工作 自动 化 ,让 
设计 人 员 有 更 多 的 精力 投身 于 方案 修改 的 工 
作息 吕 。 


1 工程 概况 


某 钢 结构 体育 馆 总 建筑 面积 1.3 万 m , 榴 高 
23. 5m。 地 下 两 层 , 地 下 一 层 为 标准 游泳 池 , 地 下 二 
层 为 设备 用 房 。 地 上 采用 双 层 大 空间 结构 , 层 间 设 
有 夹层 。 屋 架 为 正方 四 角 锥 焊接 球 空间 网 架 ,上 蓄 
周边 支撑 。 网 架 轴线 平面 尺寸 为 60m x 31. 7m , 高 
度 为 2. 6m ,屋面 设置 6% 找 坡 方便 排水 。 经 空间 结 
构 设 计 软 件 MSTCAD 计算 ,网 架 杆 件数 1 360 个 , 杆 
件 类 型 7 种 ,焊接 球 368 个 ,焊接 球 类 型 2 种 ,网 架 
在 MSTCAD 中 显示 的 空间 三 维 模型 如 图 1 所 示 。 
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1 空间 网 架 在 MSTCAD 中 的 三 维 图 


2 REVIT 网 架 模 型 创建 方式 及 存在 的 问题 


2.1 通过 盈 建 科 接口 软件 导入 Revit 

空间 网 架 在 MSTCAD 中 计算 完成 后 ,设计 人 员 
可 以 直接 通过 软件 导出 为 ANSYS 文件 .SAP2000 文 
件 和 命令 行 数据 格式 的 LOG 文本 ,也 可 以 通过 到 建 
科 软 件 作为 中 转 平台 读 取 LOG 文本 实现 网 架 分 析 
模型 到 其 他 分 析 软 件 的 互通 。 熏 建 科 软 件 还 自 带 
了 Revit 接口 补丁 ,可 以 实现 分 析 模 型 到 REVIT 模 
型 的 转换 ,但 是 转换 过 程 会 产生 一 些 错误 。 本 案例 
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通过 熏 建 科 软 件 读 取 MSTCAD 导出 的 LOG 文本 生 
成 分 析 模 型 , 再 通过 接口 软件 导入 到 Revit 中 。 生 
成 的 Revit 网 架 不 仅 没 有 球 节点 , 杆 件 也 会 发 生 轴 
线 偏 移 错 位 的 问题 ,如 图 2 所 示 。 导 出 生成 的 Revit 
网 架 模 型 并 不 能 直接 使 用 ,需要 设计 人 员 花 费 大 量 
时 间 进 行 修改 。 


2 通过 和 盈 建 科 导 入 到 Revit 生成 的 网 架 模型 


2,2 通过 创建 概念 体 量 方式 建立 网 架 

创建 网 架 概 念 体 量 模 型 并 对 其 进行 划分 网 格 ， 
以 荣 墙 说 板 填充 图 案 的 形式 创建 杆 件 和 球 节点 "| 。 
这 种 建 模 方式 比较 简洁 ,快速 。 但 是 缺点 显而易见 : 

首先 多 个 杆 件 和 球 节点 组 成 一 个 网 格 的 幕墙 
钥 极 图 案 , 如 图 3 所 示 。 人 快速 填充 幕墙 答 板 的 图 案 
建 征 的 网 架 模 型 ,节点 和 杆 件 的 尺寸 参数 是 统一 
的 5 都 从 属于 幕墙 区 板 填 充 图 案 族 。 这 种 建 模 方式 


并 不 能 单独 设置 每 个 杆 件 和 球 节点 的 参数 。 

其 次 ,由 于 幕墙 也 板 图 案 只 有 上 部 4 个 自 适应 
点 ,而 下 部 的 下 吃 节点 与 上 弦 面 的 高 度 是 定 值 ,并 
不 能 自动 调整 。 本 案例 中 的 正方 四 角 锥 眩 平面 
有 6% 找 坡 ,采用 此 方法 建 模 将 造成 下 弦 平 面 同样 
起 坡 。 创 建 的 网 架 模 型 与 实际 情况 差异 较 大 。 
2.3 常规 方式 建立 网 架 

直接 创建 杆 件 族 和 球 节点 族 ,通过 导入 CAD 文 
件 帮 助 节点 定位 ,采用 常规 方式 创建 网 架 模型 ” 。 
这 种 建 模 方式 比较 准确 ,可 以 正确 表达 网 架 模 型 的 
实际 大 小 和 构件 的 尺寸 。 但 是 这 种 建 模 方式 也 存 
在 缺点 :整个 网 架 的 建 模 工作 需要 连接 7 种 截面 杆 
件 共 1 360 个 ,放置 2 种 直径 球 节点 共 368 个 , 建 模 
工作 量 巨大 ,工作 老 琐 , 易 出 错 。 如 果 产 生 设 计 变 
更 ,构件 尺寸 的 修改 将 变 的 更 加 困难 , 且 难 以 检查 
到 产生 的 错误 。 

综 上 所 述 ,无 论 导入 还 是 直接 创建 ,网 架 在 建 
模 过 程 中 都 会 耗费 设计 者 大 量 的 精力 ,加 重 设计 工 
作 量 。 


3 基于 REVIT 的 二 次 开发 


3.1 REVIT 二 次 开发 工具 及 准备 工作 

(1) 本 文采 用 较为 普及 的 REVIT2014 版 本 、 
NET Framework 4. 5 、 Microsoft visual studio2015 编程 
环境 及 C# 编 程 语 言 ,并 添加 RevitAPL dll 和 Revi- 
tAPIUL dll 两 个 动态 链接 库 的 引用 。 


[mW 应 用 的 Er 
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(2) 网 架 模型 经 MSTCAD 计算 后 导出 为 命令 行 
数据 格式 ,生成 名 为 . log 的 文本 。 在 输出 文件 时 ， 
需 选 择 输出 数据 的 坐标 系 格式 为 右手 坐标 系 并 框 
选 输出 常规 信息 和 球 节点 信息 。 

(3) 创 建 焊 接 球 族 和 端点 为 两 个 自 适应 点 的 杆 
件 族 ,并 按照 MSTCAD 杆 件 材料 库 和 节点 规格 所 给 
出 的 参数 设置 相应 的 族 类 型 。 由 于 加 载 族 类 型 需 
要 读 取 到 LOG 文本 中 的 字符 ,所 以 族 类 型 命名 必须 
严格 按照 LOG 文本 给 出 的 名 称 进行 命名 。 

3.2 二 次 开发 的 流程 及 步骤 
程序 开发 的 流程 如 图 4 所 示 。 


配置 addin 文 件 ， 创 
建 visual studio 工 程 


读 取 mstcad 结 果 文 
本 


加 载 焊 接 球 和 杆 件 


4 程序 开发 流程 


程序 运行 步 又 ; 

(1) 读 取 MSTCAD 计算 结果 导出 的 LOG 文本 ， 
及 已 经 创建 的 Revit 族 文件 。 

(2) 按 照 文 本 给 出 的 绝对 坐标 创建 点 ,并 在 点 
上 加 载 对 应 族 类 型 的 焊接 球 族 ,再 通过 以 下 代码 创 
建 焊 接 球 节点 族 实例 : 

public void PutBall( Document RevitDoc ) 

| 


foreach( var it in Points) 

| 

Element e = RevitDoc. Create. NewFamilyInstance 
(new XYZ (it. Value. X, it. Value. Y, it. Value.Z)， 
it. Value. Symbol, StructuralType. NonStructural ) as El- 
ement ; 

dicld[ it. Key] =e. Id; 

| 

| 

(3) 设 置 提 示 信 息 ， 焊 接 球 放置 完毕 ,开始 放 
置 杆 件 ”, 缩 放 视角 便于 观察 。 

(4) 按 照 LOG 文本 配置 杆 件 族 类 型 ,获取 杆 件 
两 端 自 适应 点 ,建立 杆 件 族 实例 。 

(5) 由 于 杆 件 两 端 自 适应 点 获取 的 是 焊接 球 球 
心 点 , 需 按 实际 情况 对 杆 件 进行 剪 切 ,核心 代码 
如 下 : 

// 剪 切 “ 球 杆 链接 

让 ( dicld. ContainsKey ( idStart ) && di- 
cld. ContainsKey( idEnd) ) 

| 

Elementld eldStart = dicIdl idStart | ; 

Elementld eldEnd = dicld[ idEnd ] ; 

Flement eBalll = RevitDoc. GetElement ( el- 
dStart ) ; 

Flement eBall2 = RevitDoc. GetElement ( el- 
dFnd ) ; 

if(eBalll! =null && eBall2! =null) 

| 


JoinGeometryUtils. JoinGeometry ( RevitDoc, 
eBalll ,famInsl ) ; 
JoinGeometryUtils. JoinGeometry ( RevitDoc, 


eBall2 ,famInsl ) ; 

// 杆 一 端 和 球 剪 切 

if ( JoinGeometryUtils. AreElementsJoined ( Revit- 
Doc ,famInsl ,eBalll ) ) 

| 

InstanceVoidCutUtils. AddInstanceVoidCut ( Revit- 
Doc ,famInsl ,eBalll ) ; 

| 

// 杆 另 一 端 和 球 剪 切 

if ( JoinGeometryUtils. AreElementsJoined ( Revit- 
Doc ,famInsl ,eBall2 ) ) 

| 
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InstanceVoidCutUtils. AddInstanceVoidCut( Revit- 
Doc ,famInsl ,eBall2 ) ; 

| 

| 

| 

对 杆 件 和 球 的 剪 切 ,需要 先 将 杆 件 和 球 进 行 连 
接 后 才能 剪 切 ,焊接 空心 球 族 需 采 用 实心 球 并 空心 
剪 切 的 方式 创建 ,保证 球 和 杆 剪 切 后 空心 球 节 点 内 
部 没有 杆 件 残留 。 杆 件 和 空心 球 节 点 剪 切 效 果 前 
后 对 比 , 如 图 5 所 示 。 


图 5 杆 件 剪 切 效 果 对 比 
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加 (6) 由 于 放置 杆 件 占用 内 存 较 大 ,50 个 杆 件 设 
轻 沁 个 提示 信息 ,使 用 者 通过 点 击 弹出 框 的 确定 进 
行 启 续 工 作 , 直至 网 架 模型 生成 完毕 , 网 架 整 体 模 
型 明 图 6 所 示 。 

全 网 架 整体 上 弱 面 正确 起 坡 ,下 弦 面 仍 为 平面 ， 
整 傈 模型 和 实际 相符 。 将 视角 放大 ,可 以 看 到 模型 

G 文本 匹配 了 对 应 族 类 型 的 族 实例 ,如 图 7 


所 示 。 


7 网 架 放 大 三 维 图 


生成 网 架 模 型 的 网 格 距离 与 分 析 模 型 在 MST- 
CAD 中 的 距离 一 致 ,如 图 8 所 示 。 
本 程序 通过 “附加 模块 "命令 加 载 ,程序 自动 按 


8 ”模型 网 格 间距 
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照 读 取 的 LOG 文本 生成 Revit 网 架 模型 。 该 模型 无 
论 整体 形状 、 节 点 位 置 、 构 件 连接 关系 和 构件 斥 十 
参数 严格 按照 LOG 文本 给 出 的 数据 生成 。 由 于 
LOG 文本 是 通过 软件 导出 得 到 ,设计 人 员 只 需 按 照 
规范 在 MST 中 进行 设计 ,保证 计算 结果 的 准确 , 即 
可 生成 正确 .精准 的 网 架 模 型 。 


效率 ,提升 了 设计 质量 。 模 型 完成 后 设计 人 员 只 需 
将 模型 单独 保存 为 网 架 结 构 模 型 ,再 通过 链接 方式 
与 其 他 Revit 模型 进行 协同 设计 。 
后 续 的 开发 工作 可 以 围绕 以 下 儿 个 方面 进行 : 
(1) 采 用 建立 轴线 方式 放置 杆 件 , 生 成 曲面 网 


架 模型 ; 


(2) 通 过 提取 球 节点 半径 ,用 算法 推算 出 套 简 ， 
锥 头等 零件 的 定位 坐标 ,加 载 log 本 文 的 族 类 型 , 生 
成 具有 高 精度 完整 零件 模型 的 螺栓 球 网 架 。 

现 阶 段 REVIT 重复 性 建 模 工 作 或 高 精度 建 模 
工作 需要 耗费 设计 人 员 大 量 的 时 间 , 对 Revit 进行 
二 次 开发 自动 化 建 模 将 是 未 来 Revit 建 模 方 式 的 
主流 。 


4 结束 语 


本 文通 过 某 工程 实例 ,指出 现 阶段 三 种 创建 网 
架 方法 中 存在 的 问题 。 通 过 Revit 二 次 开发 编写 网 
架 自动 建 模 程 序 ,快速 ,准确 地 生成 Revit 网 架 模 
型 ,减少 了 大 量 的 建 模 工 作 量 。 程 序 也 可 生成 只 
标 伯 和 球 节 点 组 合 的 螺栓 球 网 架 , 适 应 于 各 种 非 曲 
面 炮 准 网 架 。 应 用 本 程序 设计 人 员 需 将 MSTCAD 
计算 结果 导出 为 log 文本 ,参照 软件 材料 库 创建 对 
应 的 Revit 族 并 参照 log 文本 对 族 类 型 正确 命名 ,局 
动 各 序 本 输入 读 取 以 上 文件 的 位 置 ， 然后 启动 Revit 【2 ] 幼 纯 乐 . Revit 自 适应 构件 功能 在 形体 和 表皮 建 模 方法 
不 本 要 任何 其 他 操作 一 键 生成 Revit 网 架 模型 。 后 es 
期 贺 膝 结构 调整 ,设计 人 员 只 需 对 MSTCAD 中 的 分 。 [3 ] 王 胜 男 .网 架 结构 优化 设计 与 BIM 施工 模拟 [D]. 大 
桥 模 型 进行 修改 ,重新 导出 log 本 文生 成 Revit 网 架 连理 工大 学 , 2016. 
模型 。 本 案例 网 架 1 360 个 杆 件 ,368 个 球 节点 重 。 [4] 罗 尧 治 .MST2016 说 明 书 .www mstcenter. com. 
新 晶 成 修改 后 的 网 架 模型 只 需 几 分 钟 ,加 快 了 设计 【5 ] JGJ7-1991, 网 架 结构 设计 与 施工 规程 [S]. 
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Automatic Modeling of Space Truss based on Revit 
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Abstract: There are many drawbacks in the present modeling of the grid structure in Revit. Due to the exces- 
sive number of components, the conventional modeling is heavy in workload and difficult in to check the errors and 
to modify them. Applying the volume modeling can be in speed, but the overall model is not accurate enough, and 
the component parameters cannot be set separately. In order to improve the design efficiency and the modeling accu- 
racy, this paper uses Microsoft’ s visual studio 2015 development platform for a secondary development of Revit to 
prepare a grid automation modeling program. This program can generate the Revit model of the welded spherical 
joints grid quickly, easily and accurately, through reading the LOG text to load the welded hollow sphere joint fami- 
ly and the member family. This program is suitable for the non-curved standard grid of welded spherical joints. The 
generated grid structure can be modified by the size of the corresponding components according to the LOG text. 
The overall size of the grid structure is in accordance with the actual situation, which greatly reduces the workload 
of the design staff. 
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